release: v0.5.0 — Windows native + multi-client docs + semantic search#125
Merged
George-iam merged 3 commits intomainfrom Apr 29, 2026
Merged
release: v0.5.0 — Windows native + multi-client docs + semantic search#125George-iam merged 3 commits intomainfrom
George-iam merged 3 commits intomainfrom
Conversation
Combined release skipping 0.3.0 / 0.4.0. Bumps version in 5 places (package.json, .claude-plugin/plugin.json, templates/plugin-README.md badge, package-lock.json via npm install --package-lock-only, README tests badge 511→536) and ships the v0.5.0 CHANGELOG entry covering PRs #118, #119, #120, #121, #122, #123, #124. Highlights: - Native Windows support (#122) — install.ps1, 3-OS CI matrix, Phase 1-4 production fixes, D-136 standalone-bundle SDK path. - Multi-client docs surfaced in README (#123) — Cursor / Windsurf / Cline / Claude Desktop / any MCP client. - Semantic search (B-005, #124) — axme_get_memory / axme_get_decision / axme_search_kb, opt-in tiered context.mode, lazy install of @huggingface/transformers, brute-force cosine, CLI config get/set + reindex, MUST-style >100-entry hint. - SEO + Glama infra (#118-#121). Verified locally: - npm test 536/536 pass - npx tsc --noEmit clean - npm run build clean Combined E2E (separately, before merge of #122/#123/#124): - Linux: setup + install runtime + reindex 30/30 + axme_search_kb semantic ranking correct ($0.47 setup, $0 search/get). - Windows native (Azure Win11 Pro 24H2 D2s_v5): same flow, 31/31 indexed, agent uses catalog correctly. VC++ Redist required for onnxruntime-node native binding (clear error message on missing). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Pure cosmetic — the error path in install.ps1 still mentioned v0.2.9 as an example argument. Update so users on a fresh install see the current release as the suggested fallback. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Every recent release (v0.2.7 → v0.5.0) has shipped or been about to
ship with at least one stale version literal that the agent missed
in the initial bump pass — lockfile not regenerated, README tests
badge outdated, install.ps1 example version still pointing at the
previous tag. The fix is institutional, not memorisation.
docs/RELEASE_CHECKLIST.md enumerates:
- The six version-literal locations to bump (package.json,
.claude-plugin/plugin.json, templates/plugin-README.md badge,
README.md tests badge, install.ps1 example, package-lock.json
via npm install --package-lock-only).
- Two grep commands that verify nothing stale remains and that the
new version appears in exactly the expected six places.
- CHANGELOG structure: theme paragraph + Added/Fixed/Changed/Removed
+ a Known-requirement section for non-obvious user-side prereqs
like the Windows VC++ Redistributable.
- Post-merge tag command for the user (D-024 — agent never tags).
- The four chained release-binary.yml jobs to watch
(build → release → publish-npm → sync-plugin-repo).
- Smoke-test steps on Linux + Windows + plugin install.
- A growing "Common things that have gone wrong" section that future
releases append to.
Also saved a memory ("read-docs-release-checklist-md-before-any-
release-prep-pr") so future agent sessions are reminded to read
the checklist end-to-end before starting any release-prep PR.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Release-prep PR for v0.5.0. Combined release skipping 0.3.0 / 0.4.0.
Bumps version in 5 places + adds CHANGELOG entry. No code changes.
Files
package.json0.2.9 → 0.5.0.claude-plugin/plugin.json0.2.9 → 0.5.0templates/plugin-README.mdbadge 0.2.9 → 0.5.0package-lock.jsonvianpm install --package-lock-onlyREADME.mdtests badge 413 → 536CHANGELOG.md[0.5.0] entry covering PRs docs(README): add Claude Code plugin install as recommended path #118-feat(search): semantic search MCP tools + tiered context mode (B-005 Phase 2) #124What ships in this release
Highlights (full detail in CHANGELOG):
install.ps1, 3-OS CI matrix, ~12 production fixes for native Windows, single TypeScript codebase produces 6 binaries.axme_get_memory/axme_get_decision/axme_search_kb, opt-incontext.mode = search, lazy install of@huggingface/transformers(no token cost — runs locally on CPU).axme-code config get / set,axme-code reindex(feat(search): semantic search MCP tools + tiered context mode (B-005 Phase 2) #124).claudePathForSdk()returns concreteclaude.exepath on Windows (fixes standalone-bundle SDK fallback crash).Verified
npm test— 536/536 pass (was 511).npx tsc --noEmit— clean.npm run build— clean.config set context.mode search(install + reindex 30/30) + claude session (axme_search_kb top-hit semantically correct, axme_get_decision returns full body, search-mode catalog visible). $0.47 for setup LLM scan, $0 for search/get (local embedder).onnxruntime-node(now produces clear error message + URL when missing).Post-merge plan
After this PR is merged to main:
.github/workflows/release-binary.ymlruns:npm publish @axme/codedist/plugin/toAxmeAI/axme-code-pluginrepoTest plan
0.5.0(verified via grep)npm install --package-lock-onlynpm testpassesnpx tsc --noEmitcleannpm run buildclean🤖 Generated with Claude Code